<html>
	<head>
		<title>Tips &amp; Tricks</title>
		<link rel="STYLESHEET" href="book.css" charset="ISO-8859-1" type="text/css"/>
	</head>
	<body>
		<h4>Tips and Tricks</h4>
		    <div class="tipGroup">General</div>
			<table class="tipTable">
				<tr>
					<td class="tipName" >Workbench Decorations</td>
					<td class="tipDetails">
						<p>
						Perforce will provide decoration on your files in Navigator or 
						the Package Explorer views (and possibly elsewhere).  To
						enable them, you need to select <span class="menu">Windows->Preferences->Workbench->Labels->Peforce</span>.
						</p>
						<p>
						Decorations include graphical ones indicate the file control-status
						(under Perforce control or not) action state (add, edit, delete), 
						and more.  Text decorations can be controlled from 
						<span class="menu">Windows->Preferences->Team->Perforce->Label Decorations</span>.
						</p>
					</td>	 
				</tr>
				<tr>
					<td class="tipName" >Team Refresh</td>
					<td class="tipDetails">
						<p>
						P4Eclipse contains a cache of information about your
						the Perforce repository.  This includes information about
						what files are in it, what changelists exists, and 
						what the state of files are with respect to changelists.
						</p>
						<p>
						When ever you do something in Eclipse that modifies
						the state of files, the cache is appropriately update.  But
						sometimes, you do things outside of Eclipse using p4, 
						p4win, or some other Perforce client.   In these cases,
						P4Eclipse needs to know that this cached information is
						invalid.  The way you do this is to select 
						<span class="menu">Team->Refresh</span> from a Resource's 
						context menu.
						</p>
					</td>	 
				</tr>
				<tr>
					<td class="tipName" >Addition Markers</td>
					<td class="tipDetails">
						<p>
						P4Eclipse will (optionally) create Information markers for
						files that are not under Perforce control.  This serves 
						as a reminder to add these files to Perforce control. 
						</p>
						<p>
						From the context menu for these markers you can select Quick Fix 
						to easily add a file to source control, or to add it the .p4ignore file.
						</p>
					</td>	 
				</tr>
				<tr>
					<td class="tipName" >.p4ignore</td>
					<td class="tipDetails">
					<p>There are several places where P4Eclipse needs to know which files are not
					under Perforce control.   But often, you have files in a project which
					you don't want under Perforce control.  .p4ignore files give you a way to
					tell P4Eclipse to ignore specific files, folders and patterns.
					</p>
					<p>.p4ignore files are simple text files, one line per entry.  Each entry
						is the name of file, folder, or a simple pattern. (* == matching 0 or more charcters).
						.p4ignore files only apply to to contents of the folder they're in.
					</p>
					</td>	 
				</tr>
			</table>

		    <div class="tipGroup">Submit Preferences</div>
		    <p>
		    	There are a number of different preferences that you can enable related to doing submits.  
		    	Each of these is controlled from the Preferences dialog.
		    </p>
			<table class="tipTable">
				<tr>
					<td class="tipName" >Add New Files</td>
					<td class="tipDetails">
						When you submit a changelist, P4Eclipse will prompt you add any new files (that 
						are not "ignored) to the change list.  For the Default change list, this 
						happens before you edit the change specification.  In many team environments,
						the most common mistake is not remembering to add new file.
					</td>	 
				</tr>
				<tr>
					<td class="tipName" >Warnings/Errors check</td>
					<td class="tipDetails">
						When you submit a changelist, P4Eclipse will prompt you if you wish to continue
						if any of the files you're submitting have a warning or error marker associated
						with them.  
					</td>	 
				</tr>
				<tr>
					<td class="tipName" >Unsaved Editors check</td>
					<td class="tipDetails">
						When you submit a changelist, P4Eclipse will check if any of the files you're
						submitting have been modified since their last save. If you do, depending on your
						prefernce settings, P4Eclipse will either automatically save them first, or
						prompt you to Continue, Save or Cancel.
					</td>	 
				</tr>
			</table>

	</body>
</html>